home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 533 / leonard6 / leonard6.txt < prev   
Encoding:
Text File  |  1991-07-05  |  7.8 KB  |  183 lines
  1.  
  2.  *---------------------------------------------------------------------*
  3.  |                                                                     |
  4.  |                    Leonard6, the Crash Handler                      |
  5.  |                        by John Eidsvoog                             |
  6.  |                   Copyright 1990 John Eidsvoog                      |
  7.  |                 Release date: Friday, July 5, 1991                  |
  8.  |                                                                     |
  9.  |  This software and the accompanying documentation are freeware and  |
  10.  |  may be distributed freely as long as they remain intact, complete, |
  11.  |  and unaltered.  It may not be sold or included with any commercial |
  12.  |  package without the written consent of the author.                 |
  13.  |                                                                     |
  14.  *---------------------------------------------------------------------*
  15.  
  16.  
  17.  * This version of Leonard6 has a new "reboot" function -- See below.
  18.  
  19.  
  20. THE INSPIRATION BEHIND LEONARD6
  21. -------------------------------
  22.  
  23. An official at Atari (who shall remain nameless) has joked publicly that
  24. Atari plans to have a head with little ones and zeros appear whenever a
  25. program crashes on the TT.  The more we thought about it, the more we
  26. realized that it might actually be a good advertising gimmick, not only
  27. on the TT but also on the ST. 
  28.  
  29. To show that we at CodeHead Software have a sense of humor, I decided to
  30. create a program that would replace the usual Atari "bombs" with little
  31. heads with ones and zeros in them.  Since this program works on all STs
  32. _and_ the TT, it further shows that we do indeed know how to make our
  33. software TT-compatible. 
  34.  
  35. The little head-shaped bomb replacements have been nicknamed leonards
  36. after the movie "Leonard - Part VI", which was quite a bomb itself.  Any
  37. similarities between the name or images used in Leonard6 and any real or
  38. imaginary figures or persons are purely coincidental.  This package was
  39. also created with a definite tongue planted in a rather large cheek. 
  40.  
  41.  
  42.  
  43. HOW TO SET IT UP
  44. ----------------
  45.  
  46. Leonard6 is a resident program.  It can be installed from the desktop or
  47. from your AUTO folder.  You can install it from the desktop (or HotWire)
  48. by simply running the program, at which time the installation message
  49. will quickly flash on the screen and return you to the desktop (or
  50. HotWire).
  51.  
  52. If you want to permanently add Leonard6 to your normal setup, simply
  53. copy it into your AUTO folder.  It will then be installed every time you
  54. boot up from that disk.  A brief message will appearing showing you that
  55. it is installed. 
  56.  
  57. If you use a resident debugger such as TEMPLMON.PRG or AMONST.PRG, you
  58. should install LEONARD6.PRG so that it runs after that debugger in your
  59. AUTO folder.  That way every time a system error occurs, the appropriate
  60. number of leonards will appear and your debugger will be invoked. 
  61. You'll be able to view the leonards by flipping to your view screen (F2
  62. in TempleMon, or 'V' in AmonST). 
  63.  
  64.  
  65.  
  66. HOW IT WORKS
  67. ------------
  68.  
  69. Leonard6 installs itself in the first 8 exception vectors, which
  70. normally point to the system's bomb-handler routine.  It replaces the
  71. routine which shows bombs on the screen for those vectors.  The vectors
  72. handled by Leonard6 and the respective number of leonards that will
  73. appear are:
  74.  
  75.      2 - Bus error
  76.      3 - Address error
  77.      4 - Illegal instruction
  78.      6 - Chk instruction
  79.      7 - Trapv instruction
  80.      8 - Privilege violation
  81.      9 - Trace mode
  82.  
  83. These are the most frequent types of system errors.  Exceptions with
  84. larger numbers will be handled by the normal system bomb-handler
  85. routine. 
  86.  
  87. If you have a resident debugger, Leonard6 will fall through to the
  88. debugger routines, otherwise it will handle errors the same as the
  89. operating system does by terminating the current program (with a Pterm). 
  90.  
  91.  
  92.  
  93. NEW "REBOOT" FUNCTION
  94. ---------------------
  95.  
  96. You can now set Leonard6 to cause a cold reset when a system crash
  97. occurs instead of just displaying leonards.  When you run Leonard6 from
  98. the desktop, an alert box will appear showing the current function of
  99. Leonard6 (reboot or display system errors).  You can choose to change
  100. the function, just install, or exit.  If you change the function and
  101. either exit or install, the new function will be written into
  102. LEONARD6.PRG so you must not change the name of the program if you want
  103. to change the function.  An alert box will inform you if the change
  104. could not be made. 
  105.  
  106. Why would you want to reboot upon system errors?  This function was added
  107. for BBS usage.  If a system crash happens while a BBS is operating it is
  108. usually more desirable if the system is rebooted so that the BBS can be
  109. re-installed.  The CodeHead Quarters BBS is run using the Michtron BBS
  110. software.  We can even take advantage of a bug in the sysop commands
  111. which causes the system to crash.  If you perform the "SCR x" command
  112. without entering a valid number ("SCR 0") the software will bomb.  We
  113. can use this to reinstall resident programs on the BBS from a remote
  114. location.  A new program can be uploaded to the system AUTO folder and
  115. then "SCR" can be used to reboot, installing the program.  <grin>
  116.  
  117.  
  118. VERSION 1.2
  119. -----------
  120.  
  121. Version 1.2 fixes a bug that caused crashing on the TT030.
  122.  
  123.  
  124.  
  125. CRASHER.PRG
  126. -----------
  127.  
  128. CRASHER.PRG is a program which simulates an illegal instruction error
  129. with Leonard6 installed so that you don't have to install Leonard6 and
  130. wait for a system error to occur.  This will help you decide if you want
  131. to install Leonard6 in your system or not.  CRASHER.PRG will not harm
  132. your system or create any problems with resident programs or
  133. accessories.  It will simply display four leonards and wait for you to
  134. press a key to terminate the program. 
  135.  
  136.  
  137.  
  138. POINTS TO NOTE
  139. --------------
  140.  
  141. 1.  Due to the larger size of the leonards compared to the size of a
  142. bomb image, on a color monitor you will only see the first 6 leonards. 
  143. Up to nine leonards are supported on a monochrome monitor. 
  144.  
  145. 2.  A divide-by-zero exception is ignored and will be immediately
  146. processed by an 'rte' instruction.  This is useful because some programs
  147. have divide-by-zero errors which TOS will ignore but TEMPLMON will
  148. intercept.  Since this can be quite irritating, Leonard6 will pass you
  149. directly back to the program without displaying any errors.  If you want
  150. to test your programs for divide-by-zero errors, you should remove
  151. Leonard6. 
  152.  
  153.  
  154.  
  155. COPYRIGHT STUFF
  156. ---------------
  157.  
  158. LEONARD6.PRG, CRASHER.PRG, and this document are Copyright 1990 John
  159. Eidsvoog.  They are freeware and may be distributed freely as long as
  160. they are unaltered and not included with any commercial products without
  161. the written consent of the author. 
  162.  
  163. Please note that Leonard6 is not a CodeHead Software product.  All
  164. CodeHead Software products are commercial programs which must be
  165. purchased through normal commercial channels.
  166.  
  167. Neither this document file (LEONARD6.TXT) nor the program files
  168. (LEONARD6.PRG and CRASHER.PRG) may be altered in any way.  Copies of
  169. these files may not be sold, and this document may not be reprinted,
  170. without the express written permission of John Eidsvoog. 
  171.  
  172. I've tried to make Leonard6 as bug-free as possible.  Nevertheless, I
  173. cannot be responsible for any damages which may occur as a result of the
  174. use (or misuse) of Leonard6.
  175.  
  176.  
  177.  ********************************************************************
  178.  *                                                                  *
  179.  * ANY SIMILARITIES BETWEEN THE NAME OR IMAGES USED IN LEONARD6 AND *
  180.  * ANY REAL OR IMAGINARY FIGURES OR PERSONS IS PURELY COINCIDENTAL. *
  181.  *                                                                  *
  182.  ********************************************************************
  183.